幾個原則
- 將資料與 UI 架構清楚分離,restfull 只在乎資料 (重要)
- 不在乎前端的狀態,所以不應當在 server 使用 Sesstion 這類
機制去存前端的狀態 (重要)
- 必須在 response 時,強制設定是否可在 server 快取,判斷依據是
是否資料會經常更改
- Restfull api 不一定是最後連接的 end point ,有可能串的 api 是中間層,
他又去串別人的 api,意思也就是你打這支 api 有可能會經過很多層,但最後
他都得連接到目標的 end point 不然無法取得正確資料。
- 一致的 interface ,通常 response 的 field 是從 db 解構出來不應該,再由
backend 自定義。
那一定會有些是從 db 撈回來後,還需要額外增加的 field,那這時你就必須額外寫提示或 comment,不然別人不知道怎麼使用,當然,最好的方式是一定要寫 doc 不然沒有人知道 field 是甚麼意思。